
@C1@c@b@_ Paint
     
       Standard paint functions.

@b Interactions

@b Leftmouse
      Pen down, i.e., start drawing. Dragging the mouse will leave marks
      on the image.

@b Middlemouse
      Pen done, i.e., finish current object.

@b Menubutton
      Set paint tool specific options.

@b Keyboard
      Use hjkl (or arrow keys) and [1-9] for minor movement and
      adjustment when such an adjustment makes sense.

      Most of the functions are standard enough and you should be able
      to figure out the interaction by trial. However, a few functions
      are implemented differently (for the better) and here is a brief
      summary:

      Unlike other paint programs, fill pattern applies to ALL closed areas,
      thus there is no fill rectangle icons. To get a filled rectangle, 
      choose the open rectangle icon and set fill pattern to solid. To get
      a real open rectangle, set the fill pattern to None. Similarly, 
      fill patterns also applies to brushes, this way, you can have many 
      different brush effects without my writing special code for it!

      Outlines of filled area will be drawn by default with current line
      width and color. To suppress the drawing of polygone outlines, set 
      line width to None.

      Another thing to bear in mind is that bit is an image touchup
      program, thus anything you draw/paint outside the image will
      be clipped. To draw/paint outside the image, enlarge the image
      via cropping first or use the merge function.

      Here are some more details:

@b Colors:
     Different colors are used for polygons and their outlines. To
     toggle which color to set, press on the appropriate buttons 
     below the color wheel.

     To set a color, either click on the color wheel or click on
     the color button. Only color button is capable of quantitative
     settings.  

@b Line Width
     Press on box with current line width. Leftmouse increments it
     and middlemouse decrements it while rightmouse allows random access 

@b Line Style
    Press on the box (next to the right of the line width box) in which
    a horizontal line is drawn with current width & style. Again, use
    left/middle mouse to cycle and rightmouse for random access.

   Other buttons: 

@b Update
     Make all changes permanent.

@b Undo
     Undo all changes made so far since last Update.

@b Create
     Create a new drawing area. Current image will be destroyed upon
     confirmation. By default, a solid white background is used for
     the newly created image. To change the background color, a fill
     operation can be applied after the creation.

@b Circles
     Circles come in two varieties. The default is to fit the circle
     between the first point and the current point. Centered option
     will make the center of the circle at the first point.

@b Cut&Paste
     Dragging the mouse defines the cut region. After a cut buffer
     becomes available, grab the region will be move the buffer
     while clicking outside the region will define a new cut region
     with current buffer deleted.  Use middlemouse to paste.

@b Fill
     Seeded fill. Useful for changing the background or large closed
     area of an image.

@b Spray
     Air brush.

@ Rays
     The first point serves as the ray source and ray by default
     terminates at the edge of a circle whose radius is determined
     by the distance between the first and the second point. Press
     menubutton to set other options. Note keyboard key hjkl and arrow
     keys can be used for minor adjustment.

@ Arcs
     Two options are available, A fan shaped section of a circle
     and an arc without the straight lines. For fan shaped arcs,
     all standard filling pattern applies. 
     
     The 1st click defines the center of the circle and the 2nd
     point defines the radius of the circle. All angles are measured
     counter-clockwise. 3rd clock terminates the arc function.

@b Note
     It is technically close to impossible to avoid reading framebuffers
     within GL, so if your interest is only placing some simple
     geometric figures on image and generate a hard copy of it, it is
     better to use the marking function, which gives you additional 
     functionality (e.g., rotated rectangles) and better hardcopy (defered
     mode).  

@b Bugs
     Output is currently done via screen dump
